Function Reference

ShellExecute

Runs an external program using the ShellExecute API.

ShellExecute ( "filename" [, "parameters" [, "workingdir" [, "verb" [, showflag]]]] )

Parameters

filename	The name of the file to run (EXE, .txt, .lnk, etc).
parameters	[optional] Any parameters for the program. Blank ("") uses none.
workingdir	[optional] The working directory. Blank ("") uses the current working directory.
verb	[optional] The "verb" to use, common verbs include: open = (default) Opens the file specified. The file can be an executable file, a document file, or a folder edit = Launches an editor and opens the document for editing. If "filename" is not a document file, the function will fail print = Prints the document file specified. If "filename" is not a document file, the function will fail properties = Displays the file or folder's properties
showflag	[optional] The "show" flag of the executed program: @SW_HIDE = Hidden window @SW_MINIMIZE = Minimized window @SW_MAXIMIZE = Maximized window

Return Value

Success:	Returns 1.
Failure:	Depends on RunErrorsFatal; see Remarks.

Remarks

After running the requested program the script continues. To pause execution of the script until the spawned program has finished use the ShellExecuteWait function instead.

By default the script will terminate with a fatal error if the ShellExecute function fails. To set @error to 1 as an indication of failure, see AutoItSetOption.

Example

; Open Notepad
ShellExecute("Notepad.exe")

; Open a .txt file with it's default editor
ShellExecute("myfile.txt", "", @ScriptDir, "edit")